BlueCielo Meridian Enterprise 2017 Configuration Guide

Configuring MicroStation document property synchronization

Similar to tag synchronization, Meridian can synchronize vault properties with the document properties of MicroStation files: Title, Subject, Author, Keywords, Comments, and so on.

To configure document property synchronization:

1. In Configurator, expand Environment in the configuration tree and select Application Link Settings. The settings for each link appear in property pages in the right pane.
2. Click the MicroStation tab. The MicroStation link’s settings page appears in the right pane.

3. Click the Edit button to modify the settings.

   Tip    To export the settings file to your computer, click the Export button. This can be useful if you would rather edit the file in your favorite text editor. You can then copy your changes to the Clipboard and paste them into Configurator.

4. Locate the section of the file that contains the document property that you want to synchronize, for example, [MicroStationSummaryInf].

   Note    The property set section names are defined in the [PropertySets] section using the following syntax:

   <COMPropertySetName>/<FMTID>=<PropertySetName>, <ProgID>

   Under normal circumstances, the definition should not be edited. If necessary, only <PropertySetName>and its corresponding property set section name may be changed. For example, changing both occurrences of MicroStationCustom to uSCustom.

5. For each document property, specify the Meridian property set and property name to which you want it synchronized.

   Tip    You can find the names of property sets and properties on the Properties page of each document type, as described in Creating and editing document types.

   Also specify a flag if the document property should be read-only (RO) or write-only (WO). Use the default lines in the file as examples. By default, document properties are read/write. Use the following format for each line:

   <DocumentPropertyName>=<PropertySet.PropertyName>,<Flag>

   The following example maps the document property Title to the Meridian property Title such that the document property is written from Meridian and not vice versa:

   Title=Custom.Title, RO

   Note    Although Meridian internal properties can be synchronized to document properties, you should never attempt to update internal properties or else Access denied errors can occur. Flag all attributes linked to Meridian internal properties as write-only (WO). Only write to Meridian properties in the Custom property set.

   If you want to synchronize a document property with a parent folder (routed) property, you must specify the folder type name from which to get the folder property as in the following example.

   <DocumentPropertyName>=<FolderTypeName:PropertySetName.PropertyName>,<Flag>

   And if you want to synchronize one document property with one of several possible routed properties, you must specify a unique identifier for each of the properties on the left side of the setting as in the following example.

   <DocumentPropertyName,ID>=<FolderTypeName:PropertySetName.PropertyName>,<Flag>

   The value of ID is insignificant but must be unique among all of the lines in the same section. Using this syntax, you can map the same document property to multiple folder types and the value will depend on the document’s actual parent folder. The following example uses three different folder types NewProject, UpgradeProject, and RepairProject.

   PROJECTNUM,new = NewProject:PSProject.ProjectNum,WO            
   PROJECTNUM,upgrade = UpgradeProject:PSProject.ProjectNum,WO            
   PROJECTNUM,repair = RepairProject:PSProject.ProjectNum,WO

6. Click OK to save your changes.
7. Test the link thoroughly by synchronizing each MicroStation document property. You can do this by changing the Meridian property values for a drawing in the vault and MicroStation document property values for the same drawing and confirming that the synchronization occurs in the way that you expect. You can manually synchronize properties with the Meridian client applications as described in the BlueCielo Meridian Enterprise User’s Guide.